<h1><?php echo __('Tagger: Documentation'); ?></h1>

<h2><?php echo __('How to use Tagger?'); ?></h2>
<p><?php echo __('You can add Tags to your pages by including this snippet into the page which you want the tags to appear.'); ?></p>
<br />
<code style="margin: 15px; font-size: 110%;">&lt;?php $this->includeSnippet('tags'); ?&gt;</code>

<h2><?php echo __('Configure Tagger'); ?></h2>
<p><?php echo __('Tagger is configurable. Set parameters by editing Snippets->tags and changing the following valid parameters.  All of the options below are optional.'); ?></p>
<p><?php echo __('<ul><li><strong>Tag Type: </strong>Set this to cloud, count or just leave it blank.<ul style="text-indent: 15px;"><li>Cloud will create a "cloud" of tags with some having larger fonts than others.  This creates a neat visual effect.</li><li>Count will create a list of tags with the number of times that tag is used.  For example <i>Tag (1)</i>.</li><li>Leaving this field blank will default to a list of tags, but without the number afer it.  For example <i>Tag</i>.</ul></li>
<li><strong>Typecase: </strong> Set this to either true or false.<ul style="text-indent: 15px;"><li>True will simply capitalize the first letter of the tag.  For example <i>tag</i> will become <i>Tag</i>.</li><li>False, which is the default (blank), will leave the tag however it was entered into the database.</li></ul></li>
<li><strong>Limit:</strong> By default it is unlimited (blank).<ul style="text-indent: 15px;"><li>You can enter a number here (without quotes) to limit the number of tags that will be displayed.</li></ul></li></ul>'); ?></p>
<br />
<code style="margin: 15px; font-size: 110%;">&lt;?php tagger('count', true, 5); ?&gt;</code>

<h2><?php echo __('Editing Default Tags'); ?></h2>
<p><?php echo __('If you would like to have the default tags, that appear in the archives just before clicking a page link, show up as links, please edit your archive and change the line that says:'); ?></p>
<br />
<code style="margin: 15px; font-size: 110%;">&lt;?php echo join(', ', $article->tags()); ?&gt;</code>
<br />
<p><?php echo __('to be:'); ?></p>
<br />
<code style="margin: 15px; font-size: 110%;">&lt;?php $i = 1; foreach($article-&gt;tags() as $tag){ ?&gt;<br /></code>
<code style="margin: 15px; font-size: 110%;">&nbsp;&nbsp;&nbsp;&nbsp;&lt;a href="&lt;?php echo BASE_URL . 'tags/' . $tag . URL_SUFFIX; ?&gt;"&gt;&lt;?php echo $tag; ?&gt;&lt;/a&gt;<br /></code>
<code style="margin: 15px; font-size: 110%;">&nbsp;&nbsp;&nbsp;&nbsp;&lt;?php echo $i == count($article->tags()) ? '.' : ', '; $i++ ?&gt;<br /></code>
<code style="margin: 15px; font-size: 110%;">&lt;?php } ?&gt;</code>
